package xx.services.entity.inter;

import javax.ws.rs.FormParam;
import javax.ws.rs.PathParam;
import javax.ws.rs.core.MultivaluedMap;

/**
 * 附件服务接口
 * 
 * @Path (Constants.RESTFUL_ROOT_PATH + "/attach")
 * @author chenx
 */
public interface IAttachInterface
{
    /**
     * 修改附件{attach_id}的名称等。
     * 
     * @PUT
     * @Path ("/{attach_id}")
     * @param name
     *            附件名称
     * @param description
     *            附件描述
     * @return
     * @author dengjinye,2010-10-29
     */
    public String updateAttach(@PathParam("attach_id")
    long attachId, @FormParam("name")
    String name, @FormParam("description")
    String description, MultivaluedMap<String, String> formParams);

    /**
     * 删除附件{attach_id}集。
     * 
     * @DELETE
     * @Path ("/{attach_id}")
     * @param attachId
     *            多个ID用“_”连接起来
     * @return
     * @author dengjinye,2010-10-29
     */
    public String deleteAttach(@PathParam("attach_id")
    String attachId);

    /**
     * 获取附件详细内容。
     * 
     * @GET
     * @Path ("/{attach_id}")
     * @param attachId
     *            -@PathParam("attach_id") 附件ID
     * @return 附件实体
     * @author dengjinye,2010-10-29
     */
    public String getAttach(@PathParam("attach_id")
    long attachId);
}
